home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / utmisc2 / clkdaemn.rdm < prev    next >
Text File  |  1996-05-20  |  3KB  |  121 lines
  1. Short:    V1.3: hardware clock at GMT util NEW: SAS/C link lib
  2. Author:   pueschel@imsdd.meb.uni-bonn.de
  3. Uploader: pueschel@imsdd.meb.uni-bonn.de
  4. Type:     util/time
  5.  
  6. ClockDaemon 1.3
  7.  
  8.  
  9. Features:
  10. ---------
  11.  
  12.  - Keeps your hardware clock at GMT (for NetBSD users).
  13.  - Patches battclock.resource so that reads and writes to the hardware
  14.    clock are transparently adjusted.
  15.  - Handles daylight savings time.
  16.  - Does not need ixemul.library.
  17.  - Sets IXGMTOFFSET for ixemul.library V 42+.
  18.  - Detects DST start & end while computer is running.
  19.  - Optionally runs command when DST begins or ends.
  20.  - DSTCheck program for use in scripts.
  21.  - NEW ! link library for SAS/C to replace broken time functions
  22.  
  23. Installation:
  24. -------------
  25.  
  26. Copy ClockDaemon and DSTCheck to C:, and add "run >NIL: ClockDaemon <command>"
  27. to your User-Startup, where <command> is a program you want to be executed when
  28. daylight savings time begins or ends. Store an appropriate (see timezone.doc)
  29. timezone string in ENVARC:TZ.
  30.  
  31. ClockDaemon will set the IXGMTOFFSET variable for ixemul.library V 42 or
  32. higher. Do not use ixtimezone !
  33.  
  34. Reboot and reset your clock to your local time via the Time preferences
  35. program.
  36.  
  37. Since version 1.2, ClockDaemon notices the start or end of daylight savings
  38. time regardless if your computer is running at that time or not. (If it is not
  39. running, the change command will be executed the next time ClockDaemon is
  40. started.)
  41.  
  42. ATTENTION: The command you want to have executed must terminate or ClockDaemon
  43.            will hang !
  44.  
  45. Example (for Germany):
  46. ----------------------
  47.  
  48. User-Startup:
  49.  
  50. run >NIL: ClockDaemon "avail flush" ; to adapt ixemul.library to new DST setting
  51.  
  52.  
  53. ENVARC:TZ:
  54.  
  55. MET-1MEST,M3.5.0,M9.5.0/03
  56.  
  57.  
  58. DSTCheck:
  59. ---------
  60.  
  61. The DSTCheck command gives you an easy way to check the DST status in CLI
  62. scripts. Its return status is WARN (5) during DST, OK (0) otherwise.
  63.  
  64. Example:
  65.  
  66. DSTCheck
  67.  
  68. If Warn
  69.   Echo "We have DST !"
  70. Else
  71.   Echo "We don't have DST !"
  72. Endif
  73.  
  74. time.lib:
  75. ---------
  76.  
  77. The original SAS/C functions gmtime, localtime, mktime and time do not
  78. work correctly. The supplied link library time.lib contains replacement
  79. functions for them. To use them, you can either copy time.lib to lib: and
  80. specify it explicitly when linking your programs, or replace the original
  81. modules in sc.lib. The script patch_sc.lib does this for you.
  82.  
  83. Programs linked with time.lib work with or without ClockDaemon installed.
  84. You are free to distribute or sell your programs containing time.lib.
  85. I only require you to add timezone.doc to such a distribution.
  86.  
  87. Legal Stuff:
  88. ------------
  89.  
  90. There is no warranty. ClockDaemon is Freeware.
  91.  
  92. Credits:
  93. --------
  94.  
  95. I borrowed the timezone string description from another package
  96. (SetTZ or TZSet or something like that). Anyway, a big "thank you"
  97. to the author.
  98.  
  99. The idea to run a script at DST start/end came from Henning Hucke.
  100.  
  101. And finally, a big "Thank You !" to Steve, Doug and Jim at SAS.
  102.  
  103. History:
  104. --------
  105.  
  106. Version 1.0: Not released.
  107.  
  108.         1.1: Added ixemul V 42 support.
  109.  
  110.         1.2: Added DSTCHANGECOMMAND.
  111.              Added detection of DST start/end while computer is on.
  112.              Added DSTCheck command.
  113.  
  114.         1.3: Restructured the code, fixed some minor bugs.
  115.              Added link library for SAS/C.
  116.  
  117. Bug reports & suggestions:
  118. --------------------------
  119.  
  120. Send bug reports & suggestions to pueschel@imsdd.meb.uni-bonn.de.
  121.